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Secure mail makes it feasible to allow privileged users such 
as IO.SysDaemon and Backup. SysDaemon to send mail, A new 
subroutine called send_mail__ sends an ASCII message, with or 
without an accompanying wakeup, to the ring I mailbox used by 
secure mail (See MTR-064 on secure mail and messages). User 
programs can call this subroutine,; as can system programs that 
have need to inform people that requests have b^en performed. 
Future mail sending and interprocess message sending commands 
will be based on send_mail_. 

A feature of send_mail__ is the ability to send by name alone 
when no project id is specified. To do this send_mail_ calls the 
entry mail_table_$ lookup , which returns a mailbox pathname for a 
given registered user. 

Users are listed voluntarily in the segment mail_table, 
wnich has the following format* 



del 1 mail_table based (mai l_table_ptr ) , 
2 version fixed bin(IZ) aligned, 
2 current__size fixed bind/) aligned, 
2 area area ( (sys__inf o_$max_seg_size ) ) ? 

del 1 table_entry based (tablep); 

2 person char (22), 

2 alias char (8), 

2 ds char (12), 

2 mbx_length fixed bind 7), 

2 he_length fixed bind 7), 

2 mbx char (mbxl refer mbx_length), 

2 he char (hel refer he_length); 



person 

alias 

ds 



mbx 



is 
is 
is 
to 
is 
mai 



the user's registered person id. 
his registered alias. 

a default destination for dprinting listings 
the user. 

the absolute pathname ending in .mbx of a 
lbox or link to a mailbox. 
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he is a default dprint header. 

The existence of mail_table and its accompanying hash table 
mail_table.nt is assured at system start up time by an answering 
service call to the entry mai l_table_$exis ts . If necessary, 
mai l_table_$exists creates a hash table by a call to hash_$make 
and creates a segment mail_table containing an initialized area. 
It allocates, for every PNT entry, an entry in mail_table with 
the following default information* 

person = id in PNT 

alias = alias in PNT 

mbx * >udd>default_project>id>id.mbx 

ds = 

he = id 

When the answering service makes certain changes to the PNT, 
such as adding a new person or changing a default project, it 
calls the add, delete or update entry in mail_table_. 
Administrative commands also exist to change mail_table 
information. 

rtriteups of the new subroutines and commands follow* 



Name * send__mail_ 



The send_mail__ subroutine sends one piece of mail to one 

user. 

Liaaas. 

del send_mail__ entry (char(*), char(*), char(*), 

ptr, fixed bin(35) ) ; 

call send_mail_ (name, prelect, message, s__ptr, code); 



1 ) name is the recipient's person_id. 

2) project is the recipient's project_id. (See Notes) 

3) message is the ASCII message. 

4) s_ptr is a pointer to the following structure, to 

comprise the beginning of the added message* 

del 1 mai l_structure aligned, 

2 version fixed bin(17), /* = 1 */ 

2 sent_from char (32) aligned, 

2 lines fixed bin(17), 

2 switches, 
3 wakeup bit ( 1 ) unaligned, 
3 urgent bit(l) unaligned, 
3 has_been_read bit(l) unaligned, 
3 acknowledge bit(l) unaligned, 
3 pad bit(32) unaligned init ( "0»b) : 

5) code is a standard status code, for example* 

error„table_$user_not_found 

Not found in mai l_t able. 
error_table_$noentry 

Mailbox does not exist. 
error_table__$no_info 

No information can be returned about recipient. 

MoJLas. 

The mailbox pathname is >udd>pro ject>name>name.mbx. 

When project is M ", the pathname of a default mailbox is 
obtained by calling mai l_table_$ lookup. 

Information on how to send is in mai l_structure and is 
stored with the message so that it can be read. The wakeup bit, 
for example, tells send_ mail_ when to send a wakeup and tells the 
mail and message reading commands which messages to print. 

pad in mai l_structure should always be zero to allow for 
defining new bits. 



iiame. 5 mail_table_ 

Tnis module manages tne data base mai l_table , which contains 
i nf orma ti on useful for sending mail and dprinting listings to 
users • 

Entry* exists 

This entry cnectcs whether mail_table and mai l_table. ht exist 
and if not, creates them. Sexists is usually called by the 
answering service. 

del mai l_table_$exists entry 

(ptr, bit(*), fixed bin(35)); 

call mail__table_$ex ists (ansp, switches, segname, code); 

I) ansp is a pointer to the answer table. (Input) 

I) switches (Output )» 

made_one mail__table and mai l__table. ht were 

created. 

old__one there was an old mail_table. this switch 

is on only when made_one is on. 

new_one a copy of mail_table exists because ther« 

is no access to write the original. 

fatal_error a fatal error is reflected in code. A 
fatal error is something like the PNT 
being the wrong version. 

3) segname is the name of the segment referred to by code if 
code is non-zero and new_one is off. If new_one is 
on, segname is the name of the copy. (Output: ) 

h) code is a normal status code. 



Entry* lookup 

This entry returns information from mail_table given a 
user's registered person id or alias as a lookup name. 

del mai l_table_$lookup entry 

(char(*), ptr, fixed bin(3b)); 

call mail_table_$ lookup (name, argp, code ) t 

1) name is a registered person id or a registered alias. 

(Input) 

2) argp is a pointer to the following structure in which 

information is returned! 

del 1 args based (argp), 

2 version fixed bind 7), 
2 person char (22), 
2 alias char (8) , 
2 mbx char ( 1 68 ) , 
2 ds char (12), 
2 he char (44); 

Every version mail^table has a different args 
structure. (Input) 

3) code is a standard status code, usually either zero or 

error_table_$user_not_f ound. (Output ) 



£ ntry t add 

This entry adds a user to mail_table. 

del mai l^table^Sadd entry (ptr, fixed bin(3b)); 
call mail_table_$add (argp, code); 

1) argp is a pointer to the above args structure. (Input) 

2) code is a standard status code. error_table_$namedup 

indicates that an entry for person already exists and 
the caller must use the delete or update entry. 
(Output) 



E-ntrv: delete 

This entry deletes a user from mail__table. 

del mail_table__$delete entry (char(*), code); 
call mail_table__$delete (name, code); 

1) name is a registered person id or alias, (Input) 

2) code is a standard status code. (Output) 

kQiry.: update 

Tnis entry updates selective information in mail_table for a 
particular user. 

del mai l_table_$update entry 

(char(*), ptr, fixed bin(35))l 

call mai l_table_$update (name, argp, code); 

1) name is a registered person id or alias. (Input) 

2.) argp is a pointer to the args structure. (Input) 

3) code is a standard status code. (Output) 

If a field in the args structure is ,M1 , that field is not 
updated in mail_table. 



ttajje.* mail_table__lookup, mil 

The mail_table_lookup command returns information from 
mail_table given a user's registered person id or alias. 

mai l__table_lookup name -control_arg- 
1) name is a registered persor. id or alias. 

CanVrol Araum&ai 

-all print the following information* 

Person registered person id 

Alias registered alias 

Mailbox pathname of default mailbox 

Destination default dprint destination 

Header default dprint header 

Default is to print only Mailbox. 

iiame,: mail_table_add f mta 

The administrative command mai l_table_add adds a user to 
mai l_table . 

mai l_table_add person alias -control args- 

1) person is a registered person id, maximum of 22 characters. 

2) alias is the registered alias, maximum of 8 characters. 

-mailbox path path is the pathname of a default 

-mbx path mailbox. If the suffix ".mbx" is 

not present, it is assumed. 

-destination string string is a default destination 
-ds string for the dprint command, no longer 

tnan 12 characters. 

-header string string is a default header for 

-he string the dprint command, no longer 

tnan 64 characters. 

iiois. 

Any fields not specified by control arguments are set to 



{iaiDfi* mai l_table_.de le te , mid 

The administrative command mai l_table_de lete removes a user 
from mail table- 

Usaofi 

mai l_table__dele te name 
I ) name is a registered person id or alias. 

An error message is printed if no entry for name exists. 



Name> mai l_table_update , mtu 

The administrative command mai l_table_update updates 
information in mail_table for a particular user. 

iisaoe 

mail_table_update name -control args- 
1) name is a registered person id or alias. 

-mailbox patn patn is the pathname of a default 

-mbx path mailbox. If the suffix ,, .mbx" is 

not present, it is assumed. 

-destination string string is a default destination 
-ds string for tne dprint command, no longer 

whan 12 characters. 

-header string string is a default header for 

-he string tne dprint command, no longer 

than 64 characters. 

ii£ie_S. 

Any fields not specified by control arguments are not 
updated. 

This command cannot replace the person id or alias. 



